home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / wterm.arc / WTERM.DOC < prev    next >
Text File  |  1985-11-20  |  8KB  |  182 lines
  1. 0660103030566
  2. 9[....................................................]
  3.  
  4.  
  5.  
  6.                            Window Term
  7.                            Version 1.0
  8.              The Desk Accessory Terminal in a Window
  9.  
  10.                                 by
  11.                            Matt Kimmel
  12.                                1987
  13.  
  14.  
  15.  
  16.      Window  Term is a terminal program in a desk  accessory.   It 
  17. differs  from  the  VT52 emulator in one major way  -  it's  in  a 
  18. window.  This means that you can keep it on the screen while doing 
  19. other things - For example, you could open Window Term while using 
  20. a word processor, and switch between your document and Window Term 
  21. - both will be on the screen.   If you've used the Control  Panel, 
  22. Window  Term  is similar to that.   It is a GEM  window  like  any 
  23. other.
  24.  
  25.      Window  Term  represents a lot  of  work.   However,  in  the 
  26. interest of getting this program to as many people as possible,  I 
  27. have made it completely public domain.   It may be distributed  in 
  28. any way.   My only request is that if you modify the source  code, 
  29. please  get  a copy of the modified source code to me.
  30.  
  31.      If  you have any questions or comments,  I can be reached  at 
  32. any of the following network addresses:
  33.  
  34. KIMMEL@UMAECS         (BITNet)
  35. KIMMEL@ECS.UMASS.EDU  (Internet)
  36. Matt Kimmel on FidoNet node 321/109
  37.  
  38.  
  39.  
  40. INTRODUCTION
  41. ------------
  42.  
  43.      Window  Term comes in two versions (both are included in  the 
  44. distribution  archive).   The  Stripped  version  is  smaller  and 
  45. faster,  but  has almost no features.   You must use  an  external 
  46. program  to  set the RS232 port when using the  Stripped  version.  
  47. The  Full  version is bigger and slower,  but  has  many  features 
  48. discussed in detail below.  It's helpful to read the documentation 
  49. for both before you decide which is best for you.
  50.  
  51.      To install the Stripped version, just copy the file WTERM.ACC 
  52. to  the root directory of a floppy or hard disk.   When  you  boot 
  53. with  that disk,  it will be listed in the 'Desk' menu  as  Window 
  54. Term.
  55.  
  56.      To  install the Full version,  copy the files WTERMF.ACC  and 
  57. WTERMF.RSC  to the root directory of a floppy or hard  disk.   The 
  58. Full version is listed in the Desk menu as Window Terminal.
  59.  
  60.  
  61.  
  62.  
  63. Stripped Version
  64. ----------------
  65.  
  66.      The stripped version, as mentioned above, is much smaller and 
  67. slightly faster than the full version.   There are two versions of 
  68. window term in order to maintain as much flexibility as  possible.  
  69. Note  that  with the Stripped version,  you must use  an  external 
  70. program  (such as the Install RS232 desk accessory or  a  terminal 
  71. program) to set the RS232 parameters.
  72.      When  you  click on Window Term,  a window will open  on  the 
  73. screen  with  the title 'Window Term' (there may be  some  version 
  74. information in the title also).   This is a full GEM window -  you 
  75. can move it,  size it, full it, close it, and select it, just like 
  76. any other window.   When the window is active,  anything you  type 
  77. will be sent to the RS232 port, and anything coming from the RS232 
  78. port will be displayed in the window.   Text will wrap at the  end 
  79. of a line and scroll just as in a text screen.
  80.      There are two special keys you should be aware of when  using 
  81. the stripped version - ALT-F toggles between the normal text  font 
  82. and the small 'icon' font (the same font that's used for the names 
  83. of icons).   ALT-S stops the text immediately.   This is necessary 
  84. because  the  terminal  is  sometimes  slower  than  the  incoming 
  85. characters,  and will keep printing backed-up characters after you 
  86. send  a CTRL-S to the remote computer.   ALT-S sends a CTRL-S  and 
  87. will  not  accept any incoming characters until  you  press  ALT-S 
  88. again.
  89.      Click  on  the Window Term entry in the desk menu  while  the 
  90. window is open for more information.
  91.      When the window is deselected (another window is made active), 
  92. Window  Term  will send a CTRL-S to the RS232 port.   When  it  is 
  93. reselected, it will send a CTRL-Q.
  94.  
  95.  
  96.  
  97. Full Version
  98. ------------
  99.  
  100.      The  Full  version  is larger and slower  than  the  stripped 
  101. version,  but has many extra features.   It takes up about 40K  of 
  102. memory, while the stripped version take up about 15K.
  103.      The Full version has all the features of the stripped version 
  104. except  the  ALT-F command (which is replaced by a  more  flexible 
  105. function  of the same sort).   In addition,  it has the  following 
  106. features:
  107.  
  108. -Ability to set RS232 parameters,  similar to the 'Install  RS232' 
  109. desk accessory
  110.  
  111. -Ability  to change the font to any of three sizes (two  sizes  in 
  112. color)
  113.  
  114. -An optional cursor
  115.  
  116. -Allows the user to set the size of the RS232 buffer
  117.  
  118. -Ability  to save all of the above parameters and the  coordinates 
  119. and size of the window to disk
  120.  
  121.      Each  of these features are discussed in  detail  below.   To 
  122. access  them,  click  on the 'Window Terminal' entry in  the  Desk 
  123. menu while the window is open.  You will be presented with a menu.  
  124. Click  on  the option you wish to use.   Each of the  options  are 
  125. discussed below.
  126.  
  127.      About  Window Term gives some information about  the  program 
  128. and credit to the author.
  129.  
  130.      Set RS232 Parameters allows you to set the Baud Rate, Parity, 
  131. Word   Length,    and   other   RS232   parameters.    It's   very 
  132. straightforward - just select the parameters you want active,  and 
  133. click on the OK button.   If you do not want to set the parameters 
  134. after all, click on the CANCEL button.
  135.  
  136.      Set RS232 Buffer Size allows you to set the size of the RS232 
  137. buffer.   The higher your baud rate,  the bigger the RS232  buffer 
  138. should be.   I find that 16K is usually more than enough for  1200 
  139. baud.   This program has not been tested with 2400 baud or higher; 
  140. please  let me know if there are any problems with  that.   If  in 
  141. doubt, though, make the RS232 buffer bigger.
  142.  
  143.      Set Character Size allows you to select any of the ST's three 
  144. character sets - the 'monochrome font', which is the character set 
  145. used with the monochrome monitor normally, the 'color font', which 
  146. is the character set normally used with the color monitor, and the 
  147. 'icon  font',  which is the tiny font used at the bottom  of  most 
  148. icons.   Using the icon font,  you can get a full 80 columns by 24 
  149. lines in a relatively small window.
  150.  
  151.      Cursor  on/off lets you select or deselect the  cursor.   The 
  152. cursor  is useful when editing lines and such,  but it slows  down 
  153. the  terminal quite a bit.   Note that backspaces are  destructive 
  154. when  you are not using the cursor,  and non-destructive when  the 
  155. cursor  is  active.   I don't recommend using  the  cursor  unless 
  156. absolutely necessary.
  157.  
  158.      Save settings saves all the above parameters and the position 
  159. and  size of the window to a file called WTERMF.INF in  your  root 
  160. directory.   The  full version of Window Terminal will attempt  to 
  161. read this file whenever it is booted.   If it can't it sets up the 
  162. default parameters.
  163.  
  164.      Cancel cancels the menu.
  165.  
  166.  
  167.  
  168. Notes and Program Revisions
  169. ---------------------------
  170.  
  171.      Thanks  to Rick Flashman,  who beta tested this  and  offered 
  172. many valuable suggestions.
  173.  
  174.      This  program  was  developed using the  Megamax  C  Language 
  175. Development System, K-Resource, and the Gulam shell.
  176.  
  177.      Version  1.0  - released 8/2/87 - first  version.   No  known 
  178. bugs.  Of course, that doesn't mean there aren't any!
  179.  
  180.  
  181.  
  182.